home *** CD-ROM | disk | FTP | other *** search
/ Atari Mega Archive 1 / Atari Mega Archive - Volume 1.iso / archiver / unzip51b.zoo / unzip.doc < prev    next >
Text File  |  1994-02-07  |  18KB  |  396 lines
  1.  
  2. UNZIP(1L)              LOCAL USER COMMANDS              UNZIP(1L)
  3.  
  4. NAME
  5.      unzip - list, test and extract compressed  files  in  a  ZIP
  6.      archive
  7.  
  8. SYNOPSIS
  9.      unzip [-Z] [-cflptuvz[ajnoqsUV$]]  file[.zip]  [file(s) ...]
  10.      [-x xfile(s) ...] [-d exdir]
  11.  
  12. DESCRIPTION
  13.      unzip will list, test, or extract files from a ZIP  archive,
  14.      commonly  found  on  MS-DOS  systems.   The default behavior
  15.      (with no options) is to extract into the  current  directory
  16.      (and  subdirectories  below it) all files from the specified
  17.      ZIP archive.  A  companion  program,  zip(1L),  creates  ZIP
  18.      archives;  both  programs are compatible with PKWARE's PKZIP
  19.      and PKUNZIP for MS-DOS.
  20.  
  21. ARGUMENTS
  22.      file[.zip]
  23.           Path of the ZIP archive(s).  If the file  specification
  24.           is  a  wildcard,  each matching file is processed in an
  25.           order determined by the operating system (or file  sys-
  26.           tem).   Only  the  filename can be a wildcard; the path
  27.           itself cannot.  Wildcard  expressions  are  similar  to
  28.           Unix egrep(1) (regular) expressions and may contain:
  29.  
  30.           *    matches a sequence of 0 or more characters
  31.  
  32.           ?    matches exactly 1 character
  33.  
  34.           [...]
  35.                matches any  single  character  found  inside  the
  36.                brackets;  ranges  are  specified  by  a beginning
  37.                character, a hyphen, and an ending character.   If
  38.                an  exclamation point or a caret (`!' or `^') fol-
  39.                lows the left bracket, then the range  of  charac-
  40.                ters within the brackets is complemented (that is,
  41.                anything except the characters inside the brackets
  42.                is considered a match).
  43.  
  44.           (Be sure to quote any character which  might  otherwise
  45.           be  interpreted  or  modified  by the operating system,
  46.           particularly under Unix and VMS.)  If  no  matches  are
  47.           found,  the  specification  is  assumed to be a literal
  48.           filename; and if that also fails, the  suffix  .zip  is
  49.           appended.  Note that self-extracting ZIP files are sup-
  50.           ported; just specify the .exe suffix  (if  any)  expli-
  51.           citly.
  52.  
  53.      [file(s)]
  54.           An optional list of archive members  to  be  processed.
  55.           Regular  expressions  (wildcards)  may be used to match
  56.           multiple members; see above.  Again, be sure  to  quote
  57.           expressions  that  would otherwise be expanded or modi-
  58.           fied by the operating system.
  59.  
  60.      [-x xfile(s)]
  61.           An optional list of archive members to be excluded from
  62.           processing.   Since wildcard characters match directory
  63.           separators (`/'), this option may be  used  to  exclude
  64.           any  files  which  are in subdirectories.  For example,
  65.           ``unzip foo *.[ch] -x */*'' would extract all C  source
  66.           files  in the main directory, but none in any subdirec-
  67.           tories.  Without the -x option, all C source  files  in
  68.           all directories within the zipfile would be extracted.
  69.  
  70.      [-d exdir]
  71.           An optional directory to which to  extract  files.   By
  72.           default,  all files and subdirectories are recreated in
  73.           the current directory; the -d option allows  extraction
  74.           in an arbitrary directory (always assuming one has per-
  75.           mission to write to the directory).  This  option  need
  76.           not  appear  at the end of the command line; it is also
  77.           accepted immediately after the  zipfile  specification,
  78.           or between the file(s) and the -x option.
  79.  
  80. OPTIONS
  81.      -Z   zipinfo(1) mode.  If the first option  on  the  command
  82.           line  is  -Z,  the  remaining  options  are taken to be
  83.           zipinfo(1) options.  See the  appropriate  manual  page
  84.           for a description of these options.
  85.  
  86.      -c   extract files to stdout/screen (``CRT'').  This  option
  87.           is  similar  to  the  -p option except that the name of
  88.           each file is printed as it is extracted, the -a  option
  89.           is  allowed,  and  ASCII-EBCDIC conversion is automati-
  90.           cally performed if appropriate.
  91.  
  92.      -f   freshen existing files, i.e., extract only those  files
  93.           which  already  exist  on disk and which are newer than
  94.           the disk  copies.   By  default  unzip  queries  before
  95.           overwriting,  but the -o option may be used to suppress
  96.           the queries.
  97.  
  98.      -l   list  archive  files   (short   format).    The   name,
  99.           uncompressed  file  size and modification date and time
  100.           of each specified file is printed,  along  with  totals
  101.           for all files specified.  If a file was archived from a
  102.           single-case file system (for example,  the  MS-DOS  FAT
  103.           file  system)  and  the  -U  option  was not given, the
  104.           filename is converted to lowercase and is prefixed with
  105.           a  caret  (^).   In  addition,  the archive comment and
  106.           individual file comments (if any) are displayed.
  107.  
  108.      -p   extract files to pipe (stdout).  Nothing but  the  file
  109.           data  is  sent  to  stdout,  and  the  files are always
  110.           extracted in binary format, just as they are stored (no
  111.           conversions).
  112.  
  113.      -t   test archive files.  This option extracts  each  speci-
  114.           fied file in memory and compares the CRC (cyclic redun-
  115.           dancy check, an enhanced checksum) of the expanded file
  116.           with the original file's stored CRC value.
  117.  
  118.      -u   update existing files and create new  ones  if  needed.
  119.           This  option  performs  the  same  function  as  the -f
  120.           option, extracting (with query) files which  are  newer
  121.           than  those with the same name on disk, and in addition
  122.           it extracts those files which do not already  exist  on
  123.           disk.
  124.  
  125.      -v   list archive files (verbose format).   In  addition  to
  126.           the information given by the -l option, the compression
  127.           method, compressed size, compression ratio  and  32-bit
  128.           CRC is listed.
  129.  
  130.      -z   display only the archive comment.
  131.  
  132. MODIFIERS
  133.      -a   convert text files.  Ordinarily all files are extracted
  134.           exactly  as they are stored (as ``binary'' files).  The
  135.           -a option causes files identified by zip as text  files
  136.           (those  with  the `t' label in zipinfo listings, rather
  137.           than `b') to be automatically extracted as  such,  con-
  138.           verting  line  endings,  end-of-file characters and the
  139.           character set itself as necessary.  (For example,  Unix
  140.           files  use  line  feeds (LFs) for end-of-line (EOL) and
  141.           have no end-of-file (EOF) marker; Macintoshes use  car-
  142.           riage  returns  (CRs)  for  EOLs; and most PC operating
  143.           systems use CR+LF for EOLs and control-Z for  EOF.   In
  144.           addition, IBM mainframes and the Michigan Terminal Sys-
  145.           tem use EBCDIC rather than the more common ASCII  char-
  146.           acter  set,  and  NT supports Unicode.) Note that zip's
  147.           identification of text files is by  no  means  perfect;
  148.           some  ``text''  files  may  actually be binary and vice
  149.           versa.    unzip   therefore   prints   ``[text]''    or
  150.           ``[binary]''  as  a  visual  check  for  each  file  it
  151.           extracts when using the  -a  option.   The  -aa  option
  152.           forces all files to be extracted as text, regardless of
  153.           the supposed file type.
  154.  
  155.      -j   junk paths.  The archive's directory structure  is  not
  156.           recreated;  all  files  are deposited in the extraction
  157.           directory (by default, the current one).
  158.  
  159.      -n   never overwrite existing  files.   If  a  file  already
  160.           exists,  skip  the  extraction  of  that  file  without
  161.           prompting.  By default unzip queries before  extracting
  162.           any  file  which already exists; the user may choose to
  163.           overwrite only the current file, overwrite  all  files,
  164.           skip extraction of the current file, skip extraction of
  165.           all existing files, or rename the current file.
  166.  
  167.      -o   overwrite existing files withou